package com.ruoyi.framework.config;

import com.ruoyi.common.utils.Threads;
import org.apache.commons.lang3.concurrent.BasicThreadFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.ScheduledThreadPoolExecutor;
import java.util.concurrent.ThreadPoolExecutor;

/**
 * 线程池配置类，用于定义和初始化系统中使用的线程池实例。
 *
 * @author ruoyi
 **/
@Configuration
public class ThreadPoolConfig {
    // 核心线程池大小
    private int corePoolSize = 50;

    // 最大可创建的线程数
    private int maxPoolSize = 200;

    // 队列最大长度
    private int queueCapacity = 1000;

    // 线程池维护线程所允许的空闲时间
    private int keepAliveSeconds = 300;

    /**
     * 创建并配置一个通用的线程池任务执行器（ThreadPoolTaskExecutor）。
     * <p>
     * 该线程池用于处理异步任务，支持设置核心线程数、最大线程数、队列容量以及线程空闲时间等参数，
     * 并使用CallerRunsPolicy策略来处理无法执行的任务。
     * </p>
     *
     * @return 配置完成的ThreadPoolTaskExecutor实例
     */
    @Bean(name = "threadPoolTaskExecutor")
    public ThreadPoolTaskExecutor threadPoolTaskExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setMaxPoolSize(maxPoolSize);
        executor.setCorePoolSize(corePoolSize);
        executor.setQueueCapacity(queueCapacity);
        executor.setKeepAliveSeconds(keepAliveSeconds);
        // 设置拒绝策略：当线程池无法处理任务时由调用线程执行任务
        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
        return executor;
    }

    /**
     * 创建并配置一个调度线程池服务（ScheduledExecutorService）。
     * <p>
     * 此线程池专门用于执行周期性或定时任务。它基于ScheduledThreadPoolExecutor实现，
     * 使用自定义命名规则的守护线程工厂，并设置了CallerRunsPolicy拒绝策略。
     * 同时重写了afterExecute方法以捕获并打印任务执行过程中的异常信息。
     * </p>
     *
     * @return 配置好的ScheduledExecutorService实例
     */
    @Bean(name = "scheduledExecutorService")
    protected ScheduledExecutorService scheduledExecutorService() {
        /**
         * 创建一个定时线程池执行器
         *
         * @param corePoolSize 核心线程池大小
         * @return 配置好的ScheduledThreadPoolExecutor实例
         */
        return new ScheduledThreadPoolExecutor(corePoolSize,
                new BasicThreadFactory.Builder().namingPattern("schedule-pool-%d").daemon(true).build(),
                new ThreadPoolExecutor.CallerRunsPolicy()) {
            /**
             * 任务执行完成后的回调方法
             * 用于捕获和处理任务执行过程中发生的异常
             *
             * @param r 执行完成的任务
             * @param t 任务执行过程中抛出的异常
             */
            @Override
            protected void afterExecute(Runnable r, Throwable t) {
                super.afterExecute(r, t);
                // 在任务执行完成后检查是否有异常发生，并打印异常堆栈信息
                Threads.printException(r, t);
            }
        };
    }
}
